home *** CD-ROM | disk | FTP | other *** search
/ MacPeople 2001 June 15 / MACPEOPLE-2001-06-15.ISO.7z / MACPEOPLE-2001-06-15.ISO / オンラインウエア / 新着！オンラインウエア16 / DiskSurveyor 2.0.1 ﾄ.sit / DiskSurveyor 2.0.1 ƒ / DiskSurveyor 2.0.1 ReadMe < prev    next >
Text File  |  2001-03-15  |  23KB  |  214 lines
  1. This document is best viewed with SimpleText.
  2.  
  3. ﾊ
  4.          DiskSurveyor
  5.                Version 2.0.1
  6.  
  7.            created by Tom Luhrs
  8.  
  9.  
  10.  
  11. Do these scenarios sound familiar?
  12.   - You're getting ready to install that new software you just bought, or you're trying to download a large file from the Internet, or maybe you're just trying to save another version of that big movie or art file you've been working onﾉ  and then you get that dreaded "There is not enough room on the disk" message...
  13.   - Or you're looking at your stack of CDROMs trying to remember which one had that file you've been looking for...
  14.  
  15. Well, DiskSurveyor doesn't promise to make your hard drive any bigger, but it does show you,  GRAPHICALLY, what or who's hogging all that space.  Click on a folder and zoom in for a closer look.  Or zoom back out.  Shift-click on a folder, and it brings up the ACTUAL folder.  And with the press of a key, you can create DiskSummary files that list all the files found on CDROMs or any other volume.  No longer will you have to waste valuable time navigating through folder after folder trying to figure out which files need to be archived or trashed to free up precious disk space.
  16.  
  17. DiskSurveyor requires System 7 or higher and at least 256 colors (or shades of gray) are recommended.
  18.  
  19. DiskSurveyor.  A different way to look at your hard drive and CDROMs.
  20. Shareware  $15 (US)
  21.  
  22. ___________________________________________________________________
  23.  
  24. Why I Created DiskSurveyor
  25.  
  26. Whether it was with my first 80 Meg hard drive or my present 30 Gig hard drive, I always seemed to be turning around and finding it to be 99% full.  Or when it came time to backup the hard disk, I would try to remove all the "extra" and "unnecessary" stuff to make the backup set smaller. (When I first had that 80 Meg drive, I used to back it up on a tall stack of floppies, so anything that didn't HAVE to be backed up made the chore go a LOT faster).  And lastly, I was getting overwhelmed with the sheer amount of information that I had on CDROM.
  27.  
  28. Now I just create a DiskSummary file for each of my CDROMs, put them all in one folder on my hard drive and use a program, like my favorite text editor BBEdit, that has the capability to search through multiple files.  No more CDROM shuffling.
  29.  
  30. Another handy use I've found for DiskSurveyor is to take "snapshots" of a disk before and after installing new software.  (Did you ever notice when reinstalling the MacOS System Software or some other large software application, that files get put in directories all around your disk?)  Now, I save a DiskSummary file of the disk before I start installing, and if I want to see which files are new or updated, I save a second DiskSummary file of the disk afterwards, and use BBEdit's Find Differencesﾉ function to show me exactly what's changed.
  31.  
  32. A Quick Overview of How DiskSurveyor Works
  33.  
  34. The easiest way to use DiskSurveyor is to use MacOS's drag-and-dropping feature.  Simply put the cursor over the volume or folder you'd like to examine, press the mouse button (don't let go), drag it on top of the DiskSurveyor icon and release the mouse button.  You can also just launch DiskSurveyor by double-clicking the DiskSurveyor icon.
  35.  
  36. Once you've scanned the volume or folder, you will see all the folders and files found within (in the same proportions as the space allocated).  The name of the volume/folder is in the panel on the left side of the screen.  The column just to the right of it contains all the files/folders found 1 level down.  In the next column to the right (if there is one) are all the files found 2 levels down.  And so on.
  37.  
  38. To see what's in a folder, just click on it.  To zoom back out, just click on the back button in the upper left corner or press the left-arrow key on the keyboard.  As you move the cursor around, the name of the file/folder you are pointing to is displayed in the status bar at the top -- along with the associated size, type/creator and date/time last modified .
  39.  
  40. In the upper right corner of the scanning window, the "More Info" window lists the totals for the volume or folder currently shown, as well as how much memory the application is currently using.  Clicking on the little triangle will open and close the "More Info" window. 
  41.  
  42. By holding down the Shift key (or the Control key, if you change the Preference) when you click on the folder, you can open up the actual folder.  DiskSurveyor will run in the background and the folder will open up on the desktop, allowing you to easily drag files to the Trash.  When you're done, just click anywhere on the DiskSurveyor window to make DiskSurveyor active again.
  43.  
  44. The status bar also has a pie chart of how full the volume currently is.  Clicking on the pie chart will bring up another window with pie charts of all mounted volumes (disks, CD-ROMs, floppies and remote (network) volumes).  Clicking on any of those will scan that volume.
  45.  
  46. DiskSummary Files
  47.  
  48. Once you have scanned a volume or folder, you can save a DiskSummary file that lists all the files by selecting "Save DiskSummaryﾉ" from the File menu.  If you have a number of folders or disks that you want to create DiskSummary files for, you can simply hold down either the Command (□) or the Option key (whichever one is chosen in the Preferences/DiskSummary dialog) while you drag-and-drop all of them on the DiskSurveyor icon or when you Open and Select a volume/folder.  The files will be created in the same folder (or on the Desktop if the volumes/folders are there) as the items being scanned.
  49.  
  50. At the beginning of the resulting DiskSummary file, there is a summary of the volume/folder something like this:  (This is similar to the information shown in the More Info window in the upper right part of the scanning window.)
  51.  
  52.                 Development
  53.  
  54.        19980909 created
  55.        20010209 last modified
  56.            1334 folders
  57.           11149 files
  58.       431350205 used
  59.       505336832 allocated
  60.            8704 minimum file size  (HFS)
  61.        40586752 volume free
  62.       545923584 volume allocated
  63.  
  64. The summary begins with the title of the volume/folder and the date it was created and last modified (in Year/Month/Day format).  It then lists how many folders and files were found followed by the number of bytes actually used and the number of bytes allocated on the disk.  Also shown is whether the volume was formatted using MacOS Standard format (HFS) or the newer MacOS Extended format (HFS Plus) which was first made available under MacOS 8.1.  Volumes using MacOS Extended format can now be as large as 2 Terabytes.
  65.  
  66. A short note on bytes allocated and minimum file size (when using MacOS Standard format (HFS)).
  67. Depending on the size of the disk (or partition of the disk), the minimum file size can vary from 512 bytes for a small disk to kilobytes for larger disks.  The general rule is that for every 33 megabytes of disk the minimum file size increases another 512 bytes.  What this really boils down to, is that for a large, unpartitioned hard disk, say a 1.2 gigabyte disk, every time you save even a small 1-byte file, 19968 bytes are allocated on the disk for that file.  If your file is 20000 bytes, it allocates 2 of these 19968-byte blocks (39936 bytes).  And so onﾉ  You can see that even saving a small amount of information on a large hard disk can take up more room than one would expect.
  68.  
  69. ﾉAnd a short note about Volume Info (when using MacOS Extended format (HFS Plus).
  70. To support HFS Plus, DiskSurveyor has to call a new system routine to get Volume Info.  The only problem is that Apple decided that it now should work a little differently than before.  As you may have noticed, when DiskSurveyor is scanning a volume, it can draw the blocks representing files and folders as it scans through them.  This is because I can find out (using the Volume Info routine), how much of the disk is being used by files before scanning, and can make the blocks in the correct proportion.  (When DiskSurveyor scans a folder, there is no equivalent system routine to report how many files and what size they are; so you'll see a little dialog saying "Scanning folderﾉ" while DiskSurveyor is totalling up all the files within.)  In Apple's new Volume Info routine, the value they now report back includes not only all the space used by files, but how much space is being used by the system for the directory structure.  The choice for me was to either scan the whole volume first before displaying it (which I felt is unacceptable given how long it can take to scan a large drive) or, having DiskSurveyor show a block (which can be sizeableﾉ  8 MB on a newly initialized HFS Plus disk) labelled as Volume Catalog Info.  I didn't really want to display this because the user can't really do anything about it, like trash it;  they can only see how much of the disk is being used for directory information.  But after further thought, I realized that DiskSurveyor is still doing the job it was created for...  showing you what's taking up all the space on your hard drive.
  71.  
  72. The last two items (volume free and volume allocated) only appear in the list when scanning a volume.  They represent the number of bytes free and the total number of bytes on the disk. As you would expect, the bytes "allocated" for files plus the bytes unused (volume free) add up to the total capacity of the disk (volume allocated). 
  73.  
  74. Following the summary is a list of all the files/folders found (one to a line) in the order they were scanned.  Here is a portion of what it looks like:
  75.  
  76. _folder_ 20010123   114M   128M System Folder
  77. _folder_ 20010123  3693K  3829K :Appearance
  78. _folder_ 20010123  1782K  1910K ::Desktop Pictures
  79. _folder_ 20010123 571824 612864 :::3D Graphics
  80. JPEGapcp 19980820 201000 214016 ::::Capsule
  81. JPEGapcp 19980820 171522 184832 ::::Tub
  82.  
  83. Each line shows:
  84.   Type/Creator - 4 characters for Type, 4 characters for Creator.  Unprintable characters are replaced by a 'ｩ' to signify a control character.
  85.   Invisible/Alias - Files/folders that are invisible will be noted as 'i';  Aliases of will be marked with an 'a'.
  86.   Last Modified Date - Year, Month, Day format.
  87.   Bytes Used - If over a megabyte, it will be a number followed by a 'K' (kilo) which means the number was divided by 1024 (1 KB);  if over 100 megabytes, the abbreviation is an 'M' (mega) meaning the number was divided by 1,048,576 (1 MB);  if over 100 gigabytes, the abbreviation is a 'G' (giga) meaning the number was divided by 1,073,741,824 (1 GB).  When abbreviated, the numbers are rounded up, if necessary.  For folders, the amount is the total bytes of all the files found within.
  88.   Bytes Allocated - Same notation as Bytes Used.  This is the actual number of bytes on the disk set aside for this file/folder.  (See the note above on bytes allocated and minimum file size.)
  89.   File Name - Indented for each level down from the volume/folder being scanned.
  90.  
  91. When viewing the DiskSummary file, as in the preceding examples, a fixed-spaced font such as 9 point Monaco was used so that all the columns line up.  Or, if you'd rather have the information in tab-separated columns, select that option in Preferences/DiskSummary.
  92.  
  93. DiskSummary files may also be loaded into DiskSurveyor (either by drag-and-dropping them on top of the DiskSurveyor application or by using the "Load DiskSummaryﾉ" command in the File menu or by double-clicking them), giving the user the ability to have "virtual" disks at their disposal.  This makes it especially easy to scan through CDROMs without having to mount and eject each one.  Just select a whole bunch of DiskSummary files and drag-and-drop them on DiskSurveyorﾉ they'll be shown one at a time (closing each one brings up the next).
  94.  
  95. See the note in the following section about making DiskSummary files that open up in your favorite text editor or word processor.
  96.  
  97. Preferences
  98.  
  99. The Preferences dialog allows you to configure DiskSurveyor in a number of ways.  Just select one of the six categories (Colors, Backgrounds, Filtering, Fonts, DiskSummary or Miscellaneous) in the left portion of the Preferences dialog.
  100.  
  101. Colors
  102. You can select what color family you would like to view the folders in, and what color family you would like to view the files in.  The only limitation is that folders and files can't be the same color families (that would be a little confusing).
  103.  
  104. Backgrounds
  105. A number of different backgrounds are available or you can select no background.
  106.  
  107. Filtering
  108. These settings tell DiskSurveyor to only highlight files and folders that match a certain criteria.  Folders and files that match are highlighted; those that don't are shown in a duller color.  There are six different types of filtering which match:
  109. 1) Everything (default) - all folders and files are highlighted.
  110. 2) Items Older Than and
  111. 3) Items Newer Than - only highlights folders and files older/newer than a selectable time period (e.g. 6 months).
  112. 4) Items Whose Name Contains - highlights only those containing the matching phrase.
  113. 5) Items Whose File Type Is - only highlights files of the chosen type (e.g. TEXT).
  114. 6) Items Whose Creator Is - highlights all files created by certain application (e.g. 8BIM is the creator code for all Adobe Photoshop files.)
  115.  
  116. For the File Type and Creator filters, you can click on the Setﾉ button, and select a file or application that you want it to match, instead of typing in the corresponding 4-character code.
  117.  
  118. Filtering can be turned on or off at any time by pressing Command (□)-F.  This toggles between Everything (no filtering) and your last chosen filtering setting.  The first time you run DiskSurveyor, pressing Command (□)-F will highlight all Items Older Than 6 months, and pressing it again will return to highlighting everything.
  119.  
  120. Fonts
  121. The first time you go to this Preferences page, it will search for all the fonts currently available in your system.  Pop-up menus will allow you to change the font used for Folder/File names and the font used in the Status Bar at the top of the window, independently.  Font sizes available for the Folder/File names are 9, 10, 12, 14, 18 and 24 points.  Font sizes available for the Status Bar are 9, 10 and 12.  When you open up the pop-up menu, the sizes available will be shown in the outline style (12 for example).  If the number is in the plain style (12), it means the font will be scaled from the closest size available.  The Next Font buttons have been added so you can quickly try out each of your fonts.  (Try changing them after you've scanned the disk -- that way you'll see immediately how they'll look as you change fonts and font size.
  122.  
  123. With larger fonts, the rectangles representing Folders/Files need to be adjusted to accommodate the longer (pixel-wise) names.  Use the Level Width pop-up menu to change this.
  124.  
  125. DiskSummary
  126. Holding the Drag & Drop List Key (Command (□) or Option) down while opening (or drag-and- dropping) a volume/folder will generate a DiskSummary file.  (This can also be done from the File menu by selecting Save DiskSummaryﾉ).
  127.  
  128. To allow the DiskSummary files created by DiskSurveyor to open up in your favorite text editor or word processor, just click on the Setﾉ button, and select either the text editor/word processor application itself, or any files created by it.  Then, the next time any DiskSummary files are saved, they will be saved just as though you had saved it from your text editor/word processor -- so double-clicking them will launch your text editor/word processor.
  129.  
  130. The Extension field contains a suffix (up to 4 characters) that will be appended to the end of any DiskSummary file saved.
  131.  
  132. Enabling the Use Tabs setting will tell DiskSurveyor to insert Tabs when saving DiskSummary files and will format the information into tab-separated columns (which looks a lot better in word processors using proportionally-spaced fonts.)
  133.  
  134. Miscellaneous
  135. Icons are displayed in the boxes representing folders and files when there's room enough for the icon.  The popup menu gives you these 4 choices:
  136. 1) Hide icons
  137. 2) Show largest icons possible (default)
  138. 3) Show large icons only
  139. 4) Show small icons only
  140.  
  141. The "More Info" window opens in the upper right corner of the scanning window.  It lists the totals for the volume or folder currently shown, as well as how much memory the application is currently using.  Clicking on the little triangle will open and close the "More Info" window. Unchecking the box for 'Open "More Info" automatically when starting scan' will keep it closed whenever another volume or folder is scanned.
  142.  
  143. Either Shift-click or Control-click can be selected so that when you hold the Shift or Control key down, and then click the mouse on a folder in the scanning window, it will open the actual folder in the Finder.
  144.  
  145. If you launched DiskSurveyor by drag-and-dropping a volume or folder on top of the DiskSurveyor icon, when you close the scanning window, DiskSurveyor will automatically quit. (If you selected multiple volumes or folders, DiskSurveyor quits after the last scanning window is closed.)  This checkbox can disable the automatic quitting feature, and DiskSurveyor will continue to run until Quit is chosen from the File menu.
  146.  
  147. Checking the Disable Allocated Bytes Warning box will prevent the warning dialog from coming up when DiskSurveyor is about to adjust the layout of a volume that was just scanned and the number of bytes found on the volume differed from the amount the volume actually thought it had.  If you are using one of the driver-level compression packages, this box should be checked to prevent this warning from coming up every time.  Those programs return the original UNCOMPRESSED number of bytes the file had, instead of the actual COMPRESSED number of bytes the file takes up on the disk.
  148.  
  149. Why You Should Send In Your Shareware Registration Fee
  150.  
  151. Although this software certainly fulfills a need that I had, I have had to work many long hours making this software as easy to use and polished as I could.  By sending in your shareware registration fee, you are supporting my efforts and telling me that it's worth my time and effort to create software like this.  The more payments I receive, the more likely I am to make further enhancements to DiskSurveyor and to develop other software.  And if you have any feature requests, I will be much more receptive if you are a REGISTERED user.
  152.  
  153. This software is being distributed in a fully-functional (uncrippled) form as Shareware.  Shareware is a distribution system under which you can take it for a "test-drive" (usually for a week or so) for evaluation purposes without obligation.  If you decide that the software is something you would like to continue using, you are required to pay a small fee (in this case $15 US) to the author; otherwise the software should be removed from your computer.  Distributing software by this method keeps the price of good, quality software lower than it would be if it were sold through the normal distribution channels.
  154.  
  155. Until you are a REGISTERED user, DiskSurveyor will pause a short time when it is first launched, and will remind you to pay your shareware registration fee.  When you do, I will give you a registration code to disable this slightly annoying plea to register, and you will never see it again.
  156.  
  157. Registered users will also be notified by e-mail when new versions of DiskSurveyor or other TwiLight Software products are released.
  158.  
  159. How To Register
  160.  
  161. To become a registered user, send $15 (US) cash or check (no foreign checks) made payable to Tom Luhrs along with your name, address and e-mail address (for fastest response) to:
  162.     Tom Luhrs
  163.     TwiLight Software / DS201
  164.     53 Austin Road
  165.     Amherst, NH 03031-2519
  166.     USA
  167. For your convenience, you may also fill out and print the file named Registration Form.
  168.  
  169. All other forms of payment (credit cards, foreign currency, etc.) should register via Kagi.  If you have Internet access and a credit card, the fastest method is to use Kagi's Online Order Processing web page -- just follow the link on the TwiLight Software web page at <http://twilightsw.com>   (SSL option is available for secure transactions.)
  170.  
  171. If you would rather not pay over the Internet (but still want Kagi to handle the payment), use the Register DiskSurveyor application included in this package.  You will need to enter your name, address, e-mail address and the method of payment.  All major credit cards, cash (most currencies), and Invoice (to be given to your accounts payable department) are accepted.
  172.  
  173. Send the data generated by the Register DiskSurveyor application to Kagi at:
  174. E-Mail:             sales@kagi.com   (fastest processing time)
  175. FAX:                 +1 510 652 6589
  176. Postal-mail:    Kagi
  177.                        1442-A Walnut Street PMB #392-C8
  178.                        Berkeley, CA 94709-1405
  179.                        USA
  180. Credit card information is encrypted by the Register DiskSurveyor program.
  181.  
  182. Quantity pricing is also available:
  183.   1-4 single-user licenses, $15 (US) per user,
  184.   5-9 single-user licenses, $12 (US) per user,
  185.   10+ single-user licenses, $10 (US) per user,
  186.   Site license, $150 (US), (Covers every user at all your organization's locations within a 10 mile radius (16 kilometers))
  187.  
  188. In return you will receive a registration code that, together with your name (make sure your name is written just the way you want it to appear on the opening splash screen), will personalize your copy of DiskSurveyor.
  189.  
  190. How To Contact TwiLight Software
  191.  
  192. Web:      <http://twilightsw.com>
  193. E-Mail:  <support@twilightsw.com>
  194.  
  195. Distribution
  196.  
  197. DiskSurveyor must be distributed in the same form that it was released in with no documentation or software missing or altered.  It may not be sold or offered for sale, or included with any other product offered for sale, except with the express written permission of Tom Luhrs and TwiLight Software.  Failure to receive permission promptly should not be taken as consent.  Companies that distribute shareware/freeware/public domain software for profit are expressly prohibited from distributing this software with the following exceptions:  1) commercial on-line services (such as America Online) and 2) if this software is being distributed on a CDROM included with a book or magazine, in which case permission should be obtained first by sending e-mail to the address above.
  198.  
  199. Limited warranty
  200.  
  201. DiskSurveyor has been tested on a number of different models of Macintosh computers, different versions of the operating system and with a variety of commonly distributed extensions and control panels.  Every known bug has been removed.  I will try to fix any bug that I can duplicate on my own machines, but I will not buy other peopleﾕs software for compatibility testing.  Any damages incurred through the use of this software beyond the shareware registration fee will not be the responsibility of Tom Luhrs or TwiLight Software.
  202.  
  203. History
  204.  
  205. Version 2.0 - February 25, 2001
  206.  -Initial release.
  207. Version 2.0.1 - March 16, 2001
  208.  -Fixed a problem with reading the file size correctly for files larger than 2 gigabytes. [MacOS 9 and later allow files larger than 2 GB]
  209.  -Added links to web page and email in About box and Register dialog (supporting the Internet control panel [in MacOS 8.5 and later] and InternetConfig [in MacOS 8.1 and earlier]).
  210.  
  211. ___________________________________________________________________
  212.  
  213. DiskSurveyor - Copyright 1996-2001,  TwiLight Software
  214.